| Statement |
Description |
| <A |
|
| LABEL=key_label |
The label that appears on the ACCEPT key when
the link is selected. key_label should be five characters
or shorter.
The LABEL option is optional. The default
label for the ACCEPT key is OK. |
| ACCESSKEY=key_num |
A number (0-9) that appears on the left side of
the screen next to the link. If the user presses the corresponding key
on the phone keypad, the phone executes the task defined by the link.
It is recommended that you number the links in
the order in which they appear. |
| TASK=task_type |
The task to execute. Possible values are:
GO: requests the URL specified by the
DEST option.
GOSUB: requests the URL specified by the
DEST option, spawning a nested activity.
RETURN: returns from a nested activity
to the previous activity.
CANCEL: cancels the current nested activity,
returning to the previous activity.
PREV: displays the previous card in the
activity history. If the current card is the first card, PREV has
the same effect as CANCEL.
CALL: places a phone call to the number
specified by the number option.
NOOP: does nothing.
See the table below for more detailed descriptions
of these tasks and the options you can use with them. |
| DEST=dest_url |
The URL to request in GO and GOSUB
tasks.
If the current activity is nested and the task
is a RETURN or CANCEL task, DEST specifies a URL to request
upon returning to the calling activity. However, if the calling activity
does not designate the current activity as "friendly," the device ignores
the DEST option. The DEST option overrides the NEXT
or CANCEL options of the calling activity. |
| REL=NEXT |
Instructs the phone to prefetch the URL specified
by the DEST option. The phone loads and caches the URL while the
user is viewing the current card.
If the user invokes the action (requesting the
URL) the phone can retrieve the URL from the cache instead of requesting
it from the UP.Link server. This gives the user a perception of enhanced
performance.
There is no guarantee that the phone will be able
to prefetch the specified URL. For example, if the phone is on a circuit-switched
network and the circuit is down, the phone will not open a circuit. If
the phone fails to execute the prefetch, it does not retry it.
If you specify the REL=NEXT option, the
URL is added to the end of the phone's cache. If the user does not request
the URL soon after the phone caches it, the phone pushes it out of the
cache, and caches other data instead.
If several tasks on a card specify the REL=NEXT
option, the phone prefetches the URLs in the order in which the tasks
are listed. |
| METHOD=get_or_post |
If the DEST option specifies a URL, the method
used to request the URL: GET or POST.
If you do not specify this option, the default,
GET, is used.
It is strongly recommended that you use the
POST method instead of the GET method. Using the POST
method ensures that the UP.Link server will properly transcode data
from the phone to the correct character set for your application (as specified
by the HTTP headers set by your application). |
| POSTDATA=data |
The data to post if the METHOD option
specifies POST. If the data contains multiple arguments, delimit
the arguments with ampersands (&). |
| ACCEPT-CHARSET=ch_set |
Specifies the character set which the HDML application
expects data returned from the phone to use.
It can specify character set names, such as the
following:
utf-8
us-ascii
iso-8859-1
shift-jis
If you do not specify the ACCEPT-CHARSET option,
the character set defaults to the character set of the deck (as specified
by the deck's HTTP headers). |
| VARS=var_pairs |
A list of variables to set for the current activity
(if the task is GO) or nested activity (if the task is GOSUB).
The variable list must be in query-string format, for example:
var1=value1&var2=value2
Variable values must be escaped according to URL
escaping conventions. The phone unescapes the VARS option before
setting the value of the variables. |
| RECEIVE=var_list |
A semicolon-delimited list of variables to which
the phone stores the return values from a GOSUB task.
The phone stores return values according to ordinal
position. For example, if you specify the following option:
receive=var1;var2
the phone stores the first return value to
var1 and the second return values to var2.
If you want to skip a return value, you must include
a semicolon as a placeholder. For example, to ignore the first return value
and store the second return value to var2, you specify the following
option:
receive=;var2 |
| RETVALS=val_list |
A semicolon-delimited list of values that an activity
invoked with GOSUB returns to the invoking activity. The RETVALS
option is allowed only with the RETURN task.
The values must be escaped according to URL escaping
conventions. |
| NEXT=next_url |
The URL to request after a nested activity returns.
If the FRIEND option in the GOSUB
task is set to TRUE, the NEXT option can be overridden
by the DEST option in the nested activity's RETURN task. |
| CANCEL=cancel_url |
The URL to request after a nested activity invoked
by a GOSUB task cancels.
If the FRIEND option in the GOSUB
task is set to TRUE, the CANCEL option can be overridden
by the DEST option in the nested activity's CANCEL task. |
| FRIEND=boolean |
A boolean value specifying whether the nested
activity specified in a GOSUB task is "friendly." A friendly nested
activity can use the DEST and CLEAR options in RETURN
and CANCEL tasks and override the NEXT and CANCEL
options of the calling task.
To indicate the nested activity is friendly, specify
TRUE. The default is FALSE. |
| SENDREFERER=boolean |
A boolean value specifying whether the UP.Browser
should provide the URL of the current deck when requesting the URL specified
by the DEST or NEXT options. If you set it to TRUE,
the UP.Browser specifies the deck's URL in the "Referer" header of the
request.
The UP.Browser attempts to use the shortest possible
relative URL in the "Referer" header if possible.
The default value is FALSE. |
| CLEAR=boolean |
A boolean value specifying whether a RETURN
or CANCEL task from a nested activity unsets all the calling
activity's variables. To unset the calling activity's variables, specify
TRUE. The default is FALSE.
The phone ignores the CLEAR option unless
the calling activity specifies that the current activity is "friendly." |
| NUMBER=number |
For a CALL task, the phone number to
call. |
| > |
|
| text |
The text for the link. The phone displays this
text in square brackets ( [ ] ). |
| </A> |
|
